home *** CD-ROM | disk | FTP | other *** search
/ Fun & Games 2 (Canada) / Fun & Games CD-ROM (Canada).bin / games / disk230 / calc.doc < prev    next >
Encoding:
Text File  |  1992-02-14  |  21.6 KB  |  595 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   Calculation
  10.  
  11.                                   Version 1.11
  12.  
  13.                                Copyright 1991 By
  14.                                    Randy Rasa
  15.                                   18215 Troost
  16.                                 Olathe, KS 66062
  17.  
  18.  
  19.  
  20.      What Is It?
  21.      ___________
  22.  
  23.         Calculation, also known as "Broken Intervals", is a solitaire card
  24.         game that requires the utmost in skill and logic.  It offers
  25.         challenging but rewarding play, and special on-screen assistance to
  26.         make it easier to play.
  27.  
  28.  
  29.      Program Requirements
  30.      ____________________
  31.  
  32.         Calculation requires 256K of memory, EGA or higher graphics
  33.         capability, and a Microsoft-compatible mouse.  If you are not sure
  34.         you have the right hardware, just run the program.  If there's a
  35.         problem, the program will let you know.
  36.  
  37.         In addition to the program file (CALC.EXE), the game requires that
  38.         the card definition files (CARDS.CD1 and CARDS.CD2) be in the
  39.         current directory.  These files contain the bit-maps for each
  40.         cardface in the deck.
  41.  
  42.  
  43.      Using The Mouse
  44.      _______________
  45.  
  46.         The mouse pointer will appear as a white arrow with black edges.
  47.         In general, the left button is used to select the object being
  48.         pointed to (a card or an on-screen button), while the right button
  49.         is used to exit menus or prompts.
  50.  
  51.         If you have a three-button mouse, the middle button will blank the
  52.         screen.  This can also be accomplished by pressing the left and
  53.         right buttons simultaneously.
  54.  
  55.  
  56.      How To Play
  57.      ___________
  58.  
  59.         Calculation uses a standard 52-card deck (no jokers).  To begin the
  60.         game the deck is shuffled, then any ace, two, three, and four are
  61.         pulled from the deck and form the start of four foundations.  These
  62.         foundations are built up according to the following sequence,
  63.         regardless of suit or color:
  64.  
  65.                             A,2,3,4,5,6,7,8,9,10,J,Q,K
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.      Calculation Documentation                                       Page 2
  76.  
  77.  
  78.                             2,4,6,8,10,Q,A,3,5,7,9,J,K
  79.                             3,6,9,Q,2,5,8,J,A,4,7,10,K
  80.                             4,8,Q,3,7,J,2,6,10,A,5,9,K
  81.  
  82.         Cards are turned up from the deck on at a time, and can be played
  83.         on the foundations or on any of four wastepiles located just below
  84.         the foundations.  The top of the wastepiles are always available
  85.         for play to a foundation, but once a card is played to a wastepile,
  86.         it cannot be moved again, except to a foundation.
  87.  
  88.         The game is won by building all four foundations up to king.  The
  89.         skill involved in playing Calculation, in addition to just keeping
  90.         track of what card goes next on each foundation, is in avoiding
  91.         covering up a card you'll need soon with a card that cannot be used
  92.         for some time, if at all.  Kings are especially troublesome, since
  93.         they cannot be moved until at least one foundation has been fully
  94.         built up.
  95.  
  96.         The general strategy is to build on the wastepiles in descending
  97.         order, but the cards are seldom so kind as to allow this to any
  98.         great degree.
  99.  
  100.  
  101.      Buttons
  102.      _______
  103.  
  104.         Along the right side of the screen are a number of "buttons", which
  105.         may be selected by pointing and clicking with the mouse.  The
  106.         buttons are:
  107.  
  108.            Options: This button brings up the options menu, which you can
  109.               use to set your preferences for the following:
  110.  
  111.               Sound: Select "Off" to disable the beeps, clicks, and various
  112.                  other noises the program makes.  Select "On" to enable the
  113.                  sounds.
  114.  
  115.               Assist: When this is set "On" the next card in each sequence
  116.                  will be displayed above each foundation to help you keep
  117.                  track of what comes next.
  118.  
  119.               Session Statistics: When this option is set to "On", the
  120.                  program will keep track of your statistics (games played,
  121.                  games won, change in average score) throughout the game
  122.                  and then display them when you quit.  (Note: During play,
  123.                  you can also display the session statistics by clicking on
  124.                  the score box.)
  125.  
  126.               Background Color: Click on the up-arrow and down-arrow to
  127.                  step through the available background colors, until you
  128.                  find one that suits your tastes.
  129.  
  130.               Card Back: Click on the up-arrow and down-arrow to cycle
  131.                  through the available card designs until you find one you
  132.                  like.  You can also click on the card back itself to bring
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.      Calculation Documentation                                       Page 3
  143.  
  144.  
  145.                  up a dialog box which will show you all the available card
  146.                  backs and allow you to choose one.
  147.  
  148.               Once you've set things to your liking, you may click on the
  149.               "OK" button to save your preferences to disk, or on the
  150.               "Cancel" button to exit the Options menu without changing
  151.               anything.
  152.  
  153.            Help: This button will bring up several pages of help screens,
  154.               which you can view by clicking on the "Next" or "Prev"
  155.               buttons to move from page to page.  When you are finished
  156.               reading the help, click on the "Done" button to exit.
  157.  
  158.            New Game: This button will end the current game, update your
  159.               statistics, and start a new game.
  160.  
  161.            Quit: Click on this button to exit the program.  If you have a
  162.               score greater than four, your statistics will be updated and
  163.               displayed briefly before returning you to DOS.  Another way
  164.               to exit the game is to press the "Abort" key (F10).  If you
  165.               press F10 (and select the "Exit This Program" option in the
  166.               pop-up dialog box or press F10 again), the program will quit
  167.               to DOS without saving the data file (and thus not giving you
  168.               a low score if you have to quit the program in the middle of
  169.               a game).  Of course you realize this is cheating, don't you?
  170.  
  171.  
  172.      Running Under Windows
  173.      _____________________
  174.  
  175.         This program will run properly under Microsoft Windows in real and
  176.         standard modes, but appears to have trouble with 386 Enhanced mode.
  177.         The program exhibits two problems when running in this mode:
  178.  
  179.            1. The mouse coordinates are shifted eight pixels down and to
  180.               the right.  This causes clicks on the upper left corner of an
  181.               object to be ignored, and clicks slightly below or to the
  182.               right of an object to be misinterpreted.
  183.  
  184.            2. The sound is sort of short and stuttering.  Eventually, after
  185.               you lose a game and the "lose" sound is played, the game
  186.               slows down to where it is unplayable.
  187.  
  188.         I have tried using a PIF file and experimenting with all the
  189.         available settings, but with no success.  However, I am not an
  190.         expert on Windows, so if anyone can figure this out, please let me
  191.         know.  In the meantime, here are three alternatives if you want to
  192.         play this game under Windows:
  193.  
  194.            1. Run Windows in real or standard mode.
  195.  
  196.            2. Turn the sound off in the "Options" menu.  You'll still have
  197.               the mouse problem, but at least the program will run at full
  198.               speed.
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.      Calculation Documentation                                       Page 4
  210.  
  211.  
  212.            2. Run the program with the new "/W" (Windows Compatability)
  213.               command-line option.  This option simply shifts the mouse
  214.               coordinates back to where they should be and uses a different
  215.               "lose" sound that doesn't appear to cause problems.
  216.  
  217.         I recognize that none of these are optimal solutions, and I hope to
  218.         improve the situation in the future.
  219.  
  220.  
  221.      Command-Line Options
  222.      ____________________
  223.  
  224.         /NC -- "No Cheat" option disables the F10 (abort) key.  Use this if
  225.                you find yourself unable to resist temptation.
  226.  
  227.         /LCD -- This option may improve the screen display on monochrome
  228.                 LCD displays.  This option simply changes a few color
  229.                 combinations to improve contrast on LCDs.
  230.  
  231.         /Rxxxxxx -- This option is used to convert a shareware version of
  232.                     the program to a registered version.  Refer to "A Note
  233.                     To Registered Users" at the end of this document for
  234.                     more information.
  235.  
  236.         /SW -- This option is used to convert a registered version to a
  237.                shareware version.
  238.  
  239.         /W -- This option forces the program to run in "Windows
  240.                Compatability" mode.  Refer to the "Running Under Windows"
  241.                section of this document for more details.
  242.  
  243.         filename.ext -- This option is for alternate data files (see
  244.                         discussion below).
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.      Calculation Documentation                                       Page 5
  277.  
  278.  
  279.      Statistics
  280.      __________
  281.  
  282.         Calculation keeps track of the score (the number of cards you've
  283.         played to the foundations), the total number of games you've
  284.         played, the number of games you've won (expressed as both a number
  285.         and a percentage), and your average score.  At the end of each
  286.         game, the statistics are written to disk, either in the default
  287.         CALC.DAT or in the data file specified on the command line.  The
  288.         data file also contains the preferences you set in the options menu
  289.         (sound on/off and background color).
  290.  
  291.         To specify a data file on the command line, start up Calculation
  292.         with the following syntax:
  293.  
  294.                                  CALC filename.ext
  295.  
  296.         This allows several different people to use the same copy of
  297.         Calculation on the same machine, yet keep separate statistics for
  298.         each person.  For example, suppose three people (Tom, Dick, and
  299.         Harry) played the game at various times on the same machine.  They
  300.         could each easily keep personalized data files, containing their
  301.         scores and preferences for sound and background color.  Tom would
  302.         use his data file by typing:
  303.  
  304.                                    CALC TOM.DAT
  305.  
  306.         Likewise, Dick and Harry could have data files called DICK.DAT and
  307.         HARRY.DAT.  Note that the "DAT" extension could be "SCR" or "HGH",
  308.         or whatever, as long as it is three letters or less.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.      Calculation Documentation                                       Page 6
  344.  
  345.  
  346.      Legalese
  347.      ________
  348.  
  349.         Calculation is shareware.  As such, you can play it, copy it, and
  350.         give it away as you wish.  In fact, you are encouraged to
  351.         distribute the program to friends, family, and strangers alike.
  352.         This includes distribution via electronic bulletin board systems
  353.         (BBS), user's groups, and disk-distribution services.  All that I
  354.         ask is that the program remain unaltered, and be distributed in an
  355.         archive consisting of:
  356.  
  357.            CALC.EXE ............. the program
  358.            CALC.DOC ............. documentation
  359.            CARDS.CD1 ............ card definition file #1
  360.            CARDS.CD2 ............ card definition file #2
  361.  
  362.  
  363.      Registration
  364.      ____________
  365.  
  366.         Calculation is shareware.  If you enjoy the game, please support
  367.         it.  There are three registration packages available:
  368.  
  369.            1. Basic Registration ................................... $5.00
  370.  
  371.               This minimum registration will get you the latest registered
  372.               (no shareware "beg" message) version of Calculation on a
  373.               diskette of your choice, along with a registration code good
  374.               for all future updates.
  375.  
  376.            2. Package Deal #1 ..................................... $10.00
  377.  
  378.               This package consists of the latest registered version of
  379.               Calculation, plus shareware versions of my other games, along
  380.               with a menu program to tie them all together.  Note that all
  381.               of the additional programs are unregistered versions (with
  382.               shareware "beg" screens).  You will also receive a
  383.               registration code good for all future updates of Calculation.
  384.  
  385.            3. Package Deal #2 ..................................... $15.00
  386.  
  387.               This package consists of the latest registered versions of
  388.               Calculation, plus registered versions of my other games,
  389.               along with a menu program to tie them all together.  Note
  390.               that all of the additional programs are fully registered
  391.               versions (no shareware "beg" screens).  You will also receive
  392.               registration codes good for all future updates of Calculation
  393.               and the other programs.
  394.  
  395.         Basic registration is available on a 5.25", 360K disk or on a
  396.         3.50", 720K disk.  The package deals are available on two 360K
  397.         disks (with the programs ZIPped (with the PKZIP compression
  398.         program) to pack as much as possible onto each disk), one 720K disk
  399.         (ZIPped), or one 5.25", 1.2M disk.  If you do not have access to
  400.         PKZIP, you'll need to order the package deals on a 1.2M disk.
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.      Calculation Documentation                                       Page 7
  412.  
  413.  
  414.         No matter what option you choose, you'll be getting a lot of
  415.         quality software for just a little dough.  Please consider
  416.         registering.
  417.  
  418.         The programs that you will get with the package deals are:
  419.  
  420.            Midnight Oil: An EGA solitaire card game, otherwise known as La
  421.               Belle Lucie and Three Shuffles and a Draw.  In this game the
  422.               deck is dealt into seventeen fans of three cards each.  Cards
  423.               are moved from the fans to four foundations, which are then
  424.               built up in suit from Ace to King.  Midnight Oil is one of
  425.               the best solitaires, affording great opportunity for skillful
  426.               play.  The game keeps statistics in a disk file, and has a
  427.               special auto mode that makes the game especially easy to
  428.               play.
  429.  
  430.            Monte Carlo: An EGA-based solitaire card game in which you try
  431.               to remove pairs of cards from a 5 x 5 matrix.  This easy-to-
  432.               play game offers hours of relaxing fun.  It keeps statistics
  433.               in much the same way as Calculation, has selectable card
  434.               designs, and a "hint" button that makes the game especially
  435.               easy to learn.
  436.  
  437.            Osmosis: In this EGA solitaire card game you have four
  438.               foundations to build, but a card can only be played to a
  439.               lower foundation if it has also been played to an upper
  440.               foundation.  This addictive game is simple to play but
  441.               difficult to win, with success often depending as much on
  442.               luck as skill.  It keeps statistics on-disk, offers
  443.               selectable card backs and has a "peek" option to give you an
  444.               extra edge.
  445.  
  446.            Idiot's Delight: An EGA version of "Aces Up", a simple but
  447.               addictive game of luck and skill.  This is one of those games
  448.               that leave you saying "just one more game" time after time
  449.               after time.  As in my other EGA games, it keeps a statistic
  450.               file and offers selectable card backs.
  451.  
  452.            Royal Cotillion: This is a two-deck EGA solitaire in which you
  453.               must build up eight foundations in suit by twos.  It offers
  454.               good opportunity for skillful play, a pleasing layout, and
  455.               hours of engrossing fun.  It keeps a statistics file, has
  456.               selectable card backs, and a time-saving auto mode.
  457.  
  458.            Concentration: An EGA graphics version of the classic memory-
  459.               stretching solitaire.  It keeps a statistics file, features
  460.               selectable card backs, and offers a unique multi-player mode.
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.      Calculation Documentation                                       Page 8
  478.  
  479.  
  480.         You can print the registration form from the initial shareware
  481.         screen.  Simply select the "Print Registration Form" button, then
  482.         select a destination, either to a printer or a file.  If you elect
  483.         to send the form to a printer, make sure it is on-line and ready.
  484.         The form should print on any standard 80-column printer.  If you
  485.         want to save the form to a file, the file "CALC.FRM" will be
  486.         created in the current directory.  You can then print out the
  487.         registration form by entering the following command from the DOS
  488.         prompt (with your printer connected and ready):
  489.  
  490.                                  COPY CALC.FRM PRN
  491.  
  492.         Then just fill out the form and send it, along with cash, check or
  493.         money order, to:
  494.  
  495.                                     Randy Rasa
  496.                                    18215 Troost
  497.                                  Olathe, KS 66062
  498.  
  499.  
  500.  
  501.  
  502.      Revision History
  503.      ________________
  504.  
  505.         1.00  01-03-91  First Public Release.
  506.         1.01  01-11-90  Added "Session Statistics" option.
  507.                         Cosmetic changes.
  508.         1.02  02-15-91  More cosmetic changes.
  509.         1.03  03-12-91  Added registration procedure.
  510.         1.04  03-23-91  Modified registration procedure.
  511.         1.05  04-23-91  Added option to print registration form.
  512.                         Changed card definition filenames to CARDS.CD*.
  513.         1.06  05-17-91  Fixed problem with equipment test.
  514.         1.07  07-01-91  Added Abort (F10) feature.
  515.                         The program now exits to DOS after running the
  516.                         registration procedure, and the program date and
  517.                         time are set correctly.
  518.         1.08  08-21-91  Added /LCD command-line switch.
  519.                         Added /M command-line switch.
  520.                         Clear message line for Help and Options menus.
  521.         1.09  09-02-91  Rewrote mouse initialization routine.
  522.                         Removed /M command-line switch.
  523.         1.10  10-28-91  Added dialog box to select card back.
  524.                         Improved parsing of command-line arguments.
  525.                         Modified the "abort" sequence so that pressing F10
  526.                         once will bring up the abort dialog box, and
  527.                         pressing F10 again will exit the program.
  528.         1.11  02-14-92  Increased number of available card backs to seven.
  529.                         Added "/NC" (No Cheat) command-line option.
  530.                         Added "/W" (Windows Compatability) command-line
  531.                          option.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.      Calculation Documentation                                       Page 9
  545.  
  546.  
  547.      A Note To Registered Users
  548.      __________________________
  549.  
  550.         The registration procedure allows previously-registered users to
  551.         update to the new registered version of the program by entering a
  552.         special 'registration code' that was included as part of your
  553.         order.  Run the shareware version of the program with the "/R"
  554.         command-line switch, followed by the registration code, like this:
  555.  
  556.            CALC /Rxxxxxx
  557.  
  558.         You would, of course use the proper registration code in place of
  559.         the "xxxxxx".  Note also that there should be no space between the
  560.         "R" and the registration code.  After running the program with /R
  561.         switch and the proper code, you'll have a brand-spanking new
  562.         registered version of the program.  What this essentially amounts
  563.         to is unlimited, free updates with each registration.
  564.  
  565.         The registration procedure comes with the following limitations:
  566.  
  567.            1. The name your EXE file must be CALC.EXE.
  568.  
  569.            2. You cannot perform the registration procedure on a compressed
  570.               version (ie: an EXE file processed with PKLite, Diet, or
  571.               LZEXE).  The EXE file may be compressed after the
  572.               registration procedure, but not before.
  573.  
  574.            3. Please do not distribute registered versions of the program.
  575.  
  576.            4. Since the registration procedure is a new feature, there are
  577.               a number of people who have registered earlier versions that
  578.               won't be able to take advantage of it just yet.  But if you
  579.               send me a self-addressed stamped envelope, I'll be happy to
  580.               send you the registration code.
  581.  
  582.  
  583.         Note: You can also change the program back to the shareware version
  584.               by using the "/SW" command-line switch.  This function is
  585.               subject to the same limitations as with the registration
  586.               procedure (ie: the program must be properly named and
  587.               uncompressed).  Please use this option to "un-register" the
  588.               program if you wish to pass it along to anyone.  Also, please
  589.               include all of the files listed under the "Legalese" section
  590.               of this document.  Thanks.
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.